Skip to content

docs: fix agent-team docs after dispatch-input hardening (#69)#110

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-agent-team-docs-post-dispatch-fix-6892b14eb481ae7b
Draft

docs: fix agent-team docs after dispatch-input hardening (#69)#110
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-agent-team-docs-post-dispatch-fix-6892b14eb481ae7b

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Follow-up documentation for #69 (fix(agent-team): fail loud on missing dispatch inputs + harden optional implementer pr_number).

Changes

README.md — uninstall label bug fix

The seventh agent-team label was listed as state:in-progress, which doesn't exist. The correct label is agent-team:reviewed (created by the installer, added to PRs by the reviewer). Expanded to per-label gh label delete commands so users can copy-paste without guessing the format.

catalog/agent-team/README.md — Input propagation gotcha expanded

The previous one-liner ("must fail loudly") didn't capture the full behavior now in the agent templates:

  • Agents check for unresolved template literals (the raw string $\{\{ github.event.inputs.issue_number }}), not just empty values.
  • Two distinct failure paths depending on whether issue_number is present or missing.
  • pr_number blank/literal treatment (implementer only) — both are valid first-dispatch states; the agent creates a new branch + PR rather than failing.

CONTRIBUTING.md — workflow count correction

"Seven dogfooded workflows" was wrong — the directory contains six workflows: three agentic (daily-repo-status, update-docs, weekly-research) and three standard CI (agentics-maintenance, ci-tests, copilot-setup-steps). Clarified that only the agentic workflows are gh aw-managed.

Test plan

  • Verify gh label delete agent-team:reviewed is runnable against a repo with the agent-team labels installed.
  • Read through catalog/agent-team/README.md "Limits and gotchas" — confirm the Input propagation entry now matches the actual agent template logic in planner-agent.md, implementer-agent.md, and reviewer-agent.md.
  • Confirm CONTRIBUTING.md workflow count matches the files in .github/workflows/.

🤖 Generated with [Claude Code]((claude.ai/redacted)

Generated by Update Docs ·

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/update-docs.md@96b9d4c39aa22359c0b38265927eadb31dcf4e2a

- README.md: fix incorrect 7th label in uninstall section
  (`state:in-progress` → `agent-team:reviewed`); expand to explicit
  per-label `gh label delete` commands for clarity
- catalog/agent-team/README.md: expand "Input propagation" gotcha to
  document the fail-loud behavior added in #69 — unresolved template
  literal detection, issue_number-missing vs. present handling, and the
  pr_number blank/literal treatment for first-dispatch vs. kickback
- CONTRIBUTING.md: fix "seven dogfooded workflows" → six (three agentic
  + three CI), and clarify that only the agentic workflows are gh-aw
  managed

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels May 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants